QuickTime 3 Reference

Previous | Chapter Top | Chapter Contents

Storing Captured Data in Multiple Files

SGSetOutputNextOutput

The SGSetOutputNextOutput function allows you to specify the order in which sequence grabber outputs should be used.

pascal ComponentResult SGSetOutputNextOutput(SeqGrabComponent s, SGOutput sgOut,
                     SGOutput nextOut);
s
Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut
Specifies the current output to use. When a new output is created, its nextOut is set to nil .
nextOut
Specifies the next output to be used. To specify that this is the last output, set this value to nil .

DISCUSSION

The SGSetOutputNextOutput function should not be called while recording.

SGGetOutputNextOutput

The SGGetOutputNextOutput function returns the next sequence grabber output for a specified output.

pascal ComponentResult SGGetOutputNextOutput(SeqGrabComponent s, SGOutput sgOut,
                     SGOutput *nextOut)
s
Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut
Specifies the current sequence grabber output.
nextOut
Contains a pointer to the next output to be used. If there is no next output, this value is nil .

SGSetOutputMaximumOffset

The SGSetOutputMaximumOffset function specifies the maximum offset for data written to a specified sequence grabber output.

pascal ComponentResult SGSetOutputMaximumOffset(SeqGrabComponent s, SGOutput sgOut,
                     const wide *maxOffset);
s
Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut
Specifies the current sequence grabber output.
maxOffset
Contains a pointer to the value of the maximum offset for data written to this output.

DISCUSSION

If an attempt is made to write data beyond the maximum offset, sequence grabber switches to the next output specified by SGSetOutputNextOutput . If no more outputs are available, an end-of-file error is returned and recording ends.

SGGetOutputMaximumOffset

The SGGetOutputMaximumOffset function returns the maximum offset for data written to the specified sequence grabber output.

pascal ComponentResult SGGetOutputMaximumOffset(SeqGrabComponent s, SGOutput sgOut,
                     wide *maxOffset);
s
Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut
Specifies the current sequence grabber output.
maxOffset
Contains a pointer to the value of the maximum offset for data written to this output.

DISCUSSION

The value of SGGetOutputMaximumOffset is initialized to (2^32 - 1) on systems with a 32-bit file system, and (2^64-1) on systems with a 64-bit file system.

SGGetOutputDataReference

The SGGetOutputDataReference function returns information about the data reference associated with the specified sequence grabber output.

pascal ComponentResult SGGetOutputDataReference(SeqGrabComponent s, SGOutput sgOut,
                     Handle *dataRef, OSType *dataRefType);
s
Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut
Specifies the current sequence grabber output.
dataRef
A pointer to the handle in which the data reference is returned. If you do not need the data reference, set this parameter to nil.
dataRefType
A pointer to an OSType value in which the type of the data reference is returned. If you do not need this information, set this parameter to nil.

DISCUSSION

The caller is responsible for disposing of the returned handle.

© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents